Overview

This page describes the pre-requisites needed to create a BYOC cluster and the installation steps.

Grid-Managed BYOC
Self-Managed BYOC

Prerequisites

To install either the Grid-Managed BYOC or Self-Managed BYOC modes, the following tools are required:

• git
• jq
• terraform
• AWS CLI - you need version 2, this is important

Installation Steps

M1 OSX

brew, pip3, and go are used in this example.

brew install git
brew tap hashicorp/tap
brew install hashicorp/tap/terraform
brew update
brew upgrade hashicorp/tap/terraform
brew install jq
pip3 install awscli --upgrade --user
export GOPATH=$(go env GOPATH)
mkdir -p $GOPATH/src/github.com/terraform-providers
cd $GOPATH/src/github.com/terraform-providers
git clone git@github.com:hashicorp/terraform-provider-null.git
cd terraform-providers-null
go vet
make fmt
make build
mkdir -p $HOME/.terraform.d/plugins/registry.terraform.io/hashicorp/null/2.1.2/darwin_arm64
cp $HOME/go/bin/terraform-provider-null $HOME/.terraform.d/plugins/registry.terraform.io/hashicorp/null/2.1.2/darwin_arm64/terraform-provider-null_2.1.2

Non-M1 OSX

brew, pip3, and go are used in this example.

brew install git
brew tap hashicorp/tap
brew install hashicorp/tap/terraform
brew update
brew upgrade hashicorp/tap/terraform
brew install jq
pip3 install awscli --upgrade --user

Linux (Debian/Ubuntu)

sudo apt-get update
# install the tools
sudo apt-get update && sudo apt-get install -y gnupg software-properties-common curl
curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -
sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main"
sudo apt-get update && sudo apt-get install terraform
sudo apt-get install git
sudo apt-get install jq
sudo apt-get install awscli

Next Steps

See:

1. Grid-Managed BYOC - for Grid Managed BYOC mode deployment instructions
2. Self-Managed BYOC - for Self Managed BYOC mode deployment instructions